/**
 * This file is part of 1genia trampoline
 * Copyright (C) 2007 1genia (contact@1genia.com)
 *
 * This library is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation; version 3 of the License. 
 *
 * This library is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details. 
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; see the file COPYING.TXT.  If not,
 * write to the Free Software Foundation, Inc., 51 Franklin Street,
 * Fifth Floor, Boston, MA 02110-1301, USA. 
 **/
package com.genia.toolbox.web.gwt.form.client.widget.item;

import java.util.List;

import com.genia.toolbox.web.gwt.form.client.manager.FormManager;
import com.genia.toolbox.web.gwt.form.client.value.FormValues;

/**
 * this interface represents the widget associated to an SimpleItem from a Form.
 * It allows to retrieve the current value of the item and to display the
 * validation errors to the user.
 */
public interface ComplexItemWidget
    extends ItemWidget
{

  /**
   * returns the current
   * {@link com.genia.toolbox.web.gwt.form.client.manager.FormManager}s of this
   * item.
   * 
   * @return a {@link List} of
   *         {@link com.genia.toolbox.web.gwt.form.client.manager.FormManager}
   *         representing the current values of this item
   */
  public List<FormManager> getFormManagers();



  /**
   * returns the current values of this item.
   * 
   * @return a {@link List} of
   *         {@link com.genia.toolbox.web.gwt.form.client.value.FormValues}
   *         representing the current values of this item
   */
  public List<FormValues> getValues();



  /**
   * set the current values of this item.
   * 
   * @param values
   *          a {@link List} of
   *          {@link com.genia.toolbox.web.gwt.form.client.value.FormValues}
   *          representing the new values of this item
   */
  public void setValues(List<FormValues> values);

}
